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PREFACE 

This manual describes the operation of the INTEL 8080 PL/M* 
Cross Compiler. The compiler comprises two distinct programs 
written in ANSI standard FORTRAN IV and may be installed on most 
medium to large scale computer systems. Some details presented 
in this manual may vary due to system dependencies and compiler 
options selected during the installation process . The PL/M lan- 
guage itself is described in the 8008 and 8080 PL/M Programming 
Mcuiual. 



PL/M is a claimed trademark of INTEL Corporation 
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1 . INTRODUCTION 

The 8080 PL/M Cross Compiler comprises two distinct programs 
which must be executed consecutively to perform a complete com- 
pilation of a PL/M source program. The two programs are known 
as Pass 1 and Pass 2 of the PL/M Compiler, and are sometimes re- 
ferred to as PLM81 and PLM82 respectively. 

The first pass reads a PL/M source program and converts it 
to an intermediate form on work files. Optionally, a listing of 
the input source program may be obtained during this pass. Errors 
in program syntax are detected at this stage, and appropriate er- 
ror messages are sent to the list file. 

The second pass of the PL/M Compiler processes the inter- 
mediate- files created by Pass 1, and generates the machine code 
for the; MCS-80 CPU. This machine code, which may be in either 
BNPP or Hex format, may be loaded and executed directly on an 
INTELLEC ® 8/Mod 80 Microcomputer Development System, or simulated 
using INTERP/80, a cross-simulator of the 8080 CPU. It may also 
be used for the programming of ROMs. Pass 2 of the compilation 
process will produce, optionally, a symbol table, and mnemonic 
listing of the generated machine code. Certain errors may be de- 
tected during this phase, and these are also reported in the list 
file*^ . 

Figure 1 illustrates the overall file structure and flow of 
program execution of the PL/M Compiler. The reader may find it 
helpful to refer to this diagram as he reads subsequent sections 
of this manual. 
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Figure 1 
File structure and flow of program execution 
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2. COMPILER CONTROLS 

The operation of each pass of the PL/M Compiler is governed 
by a set of parameters known as compiler controls, each control 
being identified by a unique letter of the alpheibet. Compiler 
controls may perform one of three ftinctions, as follows: 

a) Definition of the characteristics of the fil^s accessed 
by the PL/M Compiler, such as FORTRAN unit niunber, and 
maximum record size. 

b> Selection of those optional features of the compiler 
which are to be invoked during a particular compilation. 

c): Specification 6f various compile- time parameters , such 
as the location of the first pages of RAM and ROM in 
the object system. 

In general, each compiler control contains a non-negative 
integer value, although some controls are restricted to the 
values land O indicating an 'on* or *^off' condition, respec- 
tively. Each compiler control is provided with a default value 
which it assumes throughout the compilation process unless ex- 
plicitly altered by the user. Appendix B provides a complete 
list of the controls avaiiaible in both Pass 1 and Pass 2 of the 
PL/M compiler ,^ along with their default values. In practice, 
however, some of these defaults may have been changed during in- 
stallation of the "PL/H Compiler on any specific system. Further 
details must be obtained from your local programming or time- _ 
sharing staff. 

The value associated with any particular compiler control - 
may be changed at any stage of the compilation process by the 
compiler user; This is accomplished by a line of input with 
a dollar sign ($) in the first character position processed. 
Thus the PL/M Compiler diistihguishes between lines that belong 
to the PL/M source program proper and lines that change the 
values of compiler controls by the eUasence or presence r respec-^ 
tivelyr of a dollar sign in the first character position. Such : 
linea which alter the values of compiler controls 6u:e known as 
control records. 

Each control record may respecify the values of a number of 
compiler controls. Each specification comprises: 

a> A dollar sign (appearing in the first character position 
processed, for the first specification) . 

b) One or more letters, the first of which is that identify- 
ing the particular control (see Appendix B) , and the re- 
mainder are optional and may be used for purposes of self- 
documentation . 
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c) An equals sign (=) . 

d) A non-negative integiar^ 

Spaces are not permitted between the first two elements 
(a and b above) of a compiler control specification. They are 
permitted elsewhere. For example: 

$1=6 

is a control record which chemges the value of the I control to 6 . 

Several control specifications may appear in the Seune control 
record. Each follows the format defined above, and is separated 
from the next by zero or more space characters. For example: 

$1=6 $0=2 

is a control record which respecifies the values of the I and 
controls. Note that the new values of the controls do not become 
operative until the whole record has been processed. 

Two special specification formats are available which permit 
the user to interrogate the c\irrent values of the compiler con- 
trols. Two consecutive dollar signs {$$) appeeuring on their own 
cause the compiler to list the values of all compiler controls. 
A double dollar sign appearing in front of a control letter causes 
the value of that control to be displayed. For example, the con- 
trol record 

$ INPUT=6$OUTPUT=2$ $ INPUT$ $ 

causes the I and O controls to assume the values 6 and 2, respec- 
tively. The value of the I control is then displayed, in this 
case 6, followed by the current values of all the compiler controls, 

The user should be aware that only a small number of compiler con- 
trols may require explicit, setting during a particular compilation. 
Many will usually be supplied with a permanent valuie during system 
installation, while others control diagnostic features useful only 
in the event of compiler- failure. 
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3. FILE SYSTEM 

All input and output performed by the PL/M COTipiler is spec- 
ified in terms of ' FORTRAN Units ' , which are defined as part of 
ANSI Standard FORTRAN and provide a machine independent file ad- 
dressing scheme . 

Each FORTRAN unit is identified by a unique integer; for 
example, FORTRAN Unit 5, FORTRAN Unit 20. The compiler user directs 
input and output to specific FORTRAN units by the use of certain 
compiler controls. Each value of such a control uniquely specifies 
a FORTRAN unit. For example, in Pass 1 the I control defines the 
unit supplying source input. The mapping between control values 
and FORTRAN unit numbers is defined in Appendix C. 

In any particular installation, each FORTRAN unit will corre- 
spond either to an input/output device, such as a teletype, card 
reader or line printer; or a disk file identifj.ed by a specific 
file name. This manual does not specify the device type or file 
name corresponding to each FORTRAN tinit. This information will 
be local to any given implementation of the compiler. However, 
Appendix D provides file definitions for the versions of the 
compiler available from Tymshare, General Electric, and United 
Computing Systems, Section 5 of this manual contains an example 
of compiler operation on a PDP-10, and typical PDP-10 file names 
have been specified. 
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4. COMPILER OPERATION 

A complete compilation of a PL/M program is performed in 
two distinct phases, known as Pass 1 and Pass 2. The operatxon 
of each of these phases is discussed separately. 



4.1 Pass 1 

The first pass of the PL/M Compiler reads a PL/M^ source 
program, and generates two intermediate files (an encoded symbol 
table, and an intermediate language) which may subsequently be 
processed by Pass 2. A listing of the source program may be pro- 
duced during Pass 1, depending on whether the P compiler control 
is set 'on' or 'off (i.e. has a value of 1 or 0, respectively). 
Each line of the source file listing comprises three elements: 

b) Current level of nesting of the PL/M source, 
ci An echo of the input source record. 

Error messages may also be produced during Pass i of the 
compilation process. These tadce the form: 

(nnnnn) ERROR m NEAR s 

where nnnnn specifies the line number on which the error occurred, 
s is a symbol on the line near the error, and m specifies an 
error code which may be interpreted by reference to Appendix A. 

The operation of Pass 1 begins by taking input from the file 
specified by the default value of the I compiler control. This 
may be a card reader, or interactive terminal, for example, de- 
pending on the system configuration established during the in- 
stallation of the compiler. The compiler continues to accept 
input (both PL/M soiirce and control records) from this file until 
an^OF token is detected, indicating end-of-file, or until the 
value of the I control is respecified by a control record. In 
the latter case* input switches to the new file which has been 
specified. In this way. Pass 1 can compile a PL/M program which 
has been previously created, and is resident in a file on disk. 

Other controls commonly used during execution of Pass 1 are 
as follows: 

L Left margin. This control specifies the first character 

position of each input record to be processed during compi- 
lation. It might be used for example to instruct the compi- 
ler to ignore any sequence numbers which appear in the first 
few character positions of each record in the file. 
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Right margin. This control is similar to L, but specifies 
a right margin . 

Output. This control is similar to the I control but speci- 
fies the file which is to receive the program listing and 
error messages. For example, in some installations this 
could be the terminal, or perhaps a designated disk file. 



4.2 Pass 2 

Pasai 2 performs the second phase of a PL/M compilation by 
processing the two intermediate files generated by Pass 1. The 
operation of Pass 2 begins by accepting input from the file 
specified by the default value of the I compiler control. Nor- 
mally, this would correspond to the terminal in an interactive 
environment, or card reader in a batch environment. At this 
stage any number of control records may be input to set up the 
desired values of Pass 2 compiler controls. The end of such in- 
put is signalled by a special record containing zero or more 
space characters only. (For example: a blank card if in batch 
mode, or an extra carriage-return from a terminal.) When the 
special blank record is encountered. Pass 2 automatically pro- 
cesses the intermediate files and generates the MCS-80 object 
code. 

Pass 2 generates a list file which contains the output of 
the various compiler options - e.g. a symbol table. These op- 
tions are discussed later with their respective controls. Pass 2 
may also report on error conditions in a manner similar to Pass 1, 
and appropriate error messages will appear in the list file. A 
complete list of Pass 2 error codes is given in Appendix A. The 
user should be aware that Pass 2 errors may arise from a number 
of possible causes: 

a) A source program error xindetected by Pass 1. 

b) A compiler installation problem, or misoperation of the 
compiler. 

c) Compiler failure - for example, an internal table 
overflow. 

Compiler controls commonly used during Pass 2 are as 
follows : 

F If set. Pass 2 generates a decoded representation of the 
object code produced. 

G If set. Pass 2 generates a table indicating the approximate 
location in memory of the code produced by each line of 
PL/M source. 
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H The address, in decimal, of the start of the object code in 
memory. 

M If set. Pass 2 generates a symbol table in the list file. 

O File number of the list file (see Pass 1) . 

Q If Q is zero, the object file is in BNPF format. If Q is 
nonzero, the object file is in Hex format. 

V The niamber of the first page to be allocated as variable 

storage. If V is zero, the allocation is made automatically. 
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The exact manner in which PLM81 and PLM82 operate on any 
particular computer is implementation dependent. Figure 5-1 
gives a step-by-step example of the operation of both passes of 
^e ccanpiler on a PDP-10 computer system. Figure 5-2 shows the 
file structure and the flow of the program execution. File names 
are specified for each of the files accessed. 

Using this version, for example, the programmer places the 
PL/M sotirce program into a file named FOR20.DAT, which corresponds 
to the file referenced by a value of 6 in the I compiler control. 
This file is read when a $1=6 control record is encountered during 
PLMSl execution, PLMSl produces the intermediate files F0R22.DAT 
and FOR23.DAT, along with a spooled source file listing, by set- 
ting $0=2. The output of Pass 1 is shown in Figure 5-3. 

PLM82 is then initiated to process the intermediate files 
produced by PLMSl. Output listing is again directed to a 
spooled print file using the $0=2 control. The hexadecimal 
object file produced by PLM82 is written to the file F0R21.DAT. 

The output of the $G compiler option is illustrated by Figure 
5-4 . It comprises a tcdale whose entries each have two numbers , 
separated by an equals sign. To the left of an equals sign is a ' 
source line number, and to the right is the approximate location, 
in hexadecimal, of the object code generated by the specified 
source line. 

The output of the $M compiler option is illustrated by Figure 
5-5, It comprises a table of PL/M identifiers (variables, labels, 
and procedures) in order of their appearance in the PL/M source, 
along with their assigned locations in memory (in hexadecimal) . 

The output of the $F compiler control is illustrated by 
Figure 5-6, The left hand column of the table identifies loca- 
tions in memory, and the entries in the remainder of each row in- 
dicate the initial contents of the designated memory locations. 
Operation codes are expressed in a mnemonic format, similar to 
the mnemonics accepted by the 8080 assembler. Other locations, 
for example those initialized by a DATA statement or INITIAL 
attribute, are expressed as hexadecimal numbers. 

Figtire 5-7 shows the hexadecimal object file produced by 
Pass 2. This comprises two sections: 

a) A symbol map consisting of symbol niunbers, names, and 
hexadecimal memory locations. This map is used by the 
8080 cross simulator to provide symbolic debugging 
facilities. 

b) Hexadecimal object code in standard 8080 format. 
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. COPY F0R2 . DAT=MYPROG . PLM (1) 

. RUN PLM81 C2) 

8080 PLMl VERS 2.0 (3) 

$0=2 $1=6 (^) 

NO PROGRAM ERRORS (5) 

. RUN PLM82 (6) 

8080 PLM2 VERS 2.0 (7) 

$0=2 $F=I $G=1 (8) 

(9) 

NO PROGRAM ERRORS (iO) 

. PRINT *.LPT . (li) 

.PUNCH F0R2l.DAT (12> 



(1> Copy the source program into file FOR20.DAT from file 
MYPROG.PLM. 

(2) Invoke Pass 1 of the PL/M Compiler. 

(3) PL/M Compiler types its identity. „«„oa 

(4) Divert input to file number 6, which corresponds to FOR20. 
DAT. Divert output to file number 2, the spooled list file 

"(5> Pass 1 types an emror siammary. 

(6) Invoke Pass 2 of the PL/M Compiler. 

(7) Pass 2 types its identity. , ^ ^^ „ ^ 

(8) Divert output to a spooled list file, and select the F and. 
G compiler options. 

(9) Blank line starts Pass 2 compilation process. 
{10> Pass 2 types an error summary. 

(IIV The spooled list files are printed. , >,. 

(12) The Pass 2 Hex output is pianched, for subsequent loadxng 
to an INTELLEC 8/MOD 80 Microcomputer Development System. 



Note-. Underlined commands are those typed by the user. 



Figure 5-1 Cpmpiler Operation on a PDP-10 
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Figure 5-2 
File structure and flow of program execution on a PDP-10 
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SAMPLE PL/M PROGRAM 

THIS PROGRAM CALCULATES AND PRINTS OUT THE SQUARE ROOTS OP 
ALL INTEGERS BETWEEN 1 AND 1000. 



V 



DECLARE CR LITERALLY '0DH', LF LITERALLY '0AH', TRUE LITERALLY '1', 
FALSE LITERALLY '0'r 

10Ht /* IS THE ORIGIN OF THIS PROGRAM */ 

SQUARES ROOT t PROCEDURE (X) BYTE; 
DECLARE (X,Y,Z) ADDRESS} 
Y«X» l-SHR(X+l,l) J 

DO WHILE YOZ; 

Y-Zj Z"SBR{X/Y + Y ♦ 1, 1); 

END; 
RETURN Yt 
END SQDAREROOTr 

/* PRINT USING INTELLEC MONITOR */ 
PRINTSCHARt PROCEDURE (CHAR) t 
DECLARE CHAR BYTE; 
DECLARE lOCO LITERALLY '3809H'; 
GO TO lOCO; 
END PRINT$CHAR; 

PRlNTSSTRINGt PROCEDURE (NAME, LENGTH) ? 
DECLARE NAME ADDRESS, 

(LENGTH,I,CHAR BASED NAME) BYTE; 
DO I * TO LENGTH'l; 
CALL PRINT$CHAR(CHAR(I)); 
END; 
END PRINT$STRING; 

PHINT$NDMBBRt PROCEDDRE(NDMBER,BASE,CHARS,ZERO$SUPPRESS) ; 

DECLARE NUMBER ADDRESS, (BASB,CHARS,ZEROSSUPPRESS,I,J) BYTE; 

DECLARE TEMP (16) BYTE; 

IF CHARS > LAST(TEMP) THEN CHARS • LAST(TEMP) ; 

DO r " 1 TO CHARS; 

J-NUNBER MOO BASE ••> '0'; 

IF J > *9' THEN J • J + 7; 

IF ZBRO$SUPPRESS AND I <> 1 AND NUMBER - THEN 

J « ; 

TEMP (LENGTH (TEMP) -I) - Jf 

NUMBER - NUMBER / BASE; 

BNDs 
CALL PRINT$STRING(.TEMP + LENGTH(TEMP) - CHARS, CHARS ) ; 

END FRINTSNUMBER; 

DECLARE 1 ADDRESS, , 

CRLF LITERALLY CR,LF , 

HEADING DATA (CRLF,LF,LF, , „„,„,„ 

TABLE OF SQUARE ROOTS , CRLF,LF, 
' VALUE HOOT VALUE ROOT VALUE ROOT VALUE ROOT VALUE ROOT , 
CRLF,LFyr 

/* SILENCE TTY AND PRINT COMPUTED VALUES •/ 
00 I - I TO 1000; 
IF I MOD 5-1 THEN 

DOt IF I MOD 25r - 1 THEIT 

CALL PRIHT$STRING( .HEADING, LENGTH(HEADING) ) ; 

ELSE 

CALL PRINT$STRING(.(CR,LF) ,2); 

CALL"pRiNTSNUMBER(I,10,6,TRUE /* SUPPRESS LEADING ZEROES •(); 

CALL PHINT$NUMBER(S0UARESROOT(I) , 10,6, TRUE); 

END; 

EOF 



NO PROGRAM ERRORS 



Figure 5-3 Souxce Program Listing-Pass 1 
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1-0003H 
17-00B1H 
29»00D0fr 
37»00F8H 
44»0156H 
50«01ABH 
63-027BH 
69»02C6H 



12«0013H 
18-00BAH 
31=00D3H 
39»00FCH 
45«015AH 
56»021EH 
64»027EH 



13«0016H 
19>00C0H 
32«00bEH 
40»00FFH 
46»016AH 
59-0226H 
65«0288H 



14>001CH 
23«00C4H 
33»00EAH 
41=010FH 
47»0186H 
60-0235H 
66-0292H 



15»002FH 
25-00C7H 
34=00F1H 
42-012CH 
48»0191H 
61«0251H 
67«029DH 



16»0045H 
26'00C8H 
35»00F2H 
43=0139H 
49«01AAH 
62«0270H 
68«02B7H 



Figure 5-4 Source Line Number-Code Location 
Cross Reference Listing-Pass 2 
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MEMORY 0300H 

SQUAREROOT 0016H 

X 02DAH 

y ., 02DCH 

i......... /....... 02DEH 

PRINTCHAR 0C0H 

CHAR 02B1H 

PRINTSTRING 00C8H 

NAME ....02E2H 

LENGTH .....02E4H 

I ..02E5H 

PRINTNOMBER 00F2H 

NUMBER. .02E6H 

BASE ...02E9H 

CHARS • »2EAH 

2ER0SUPPRESS . 02EBH 

I . 02ECH 

j'*^,** 02EDH 

TEMP.... .........••»»..• .•.•..•.02EEH 

1. .02FEH 

HEADING.................... --..-^lABH 



Figure 5-5 Symbol Table-Pass 2 
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eaiBH LXI SP D4H a2H JMP lEH 02H 

afll9H MOV MC INX H MOV MB DCB L MOV CM INK L 

0e22B INX H MOV MB LBLD DAH 

0e2BH RAR MOV DA MOV AE RAR 

00348 MOV HD LXI H DCS 02H 

003DH INR L MOV CA MOV AB SBC M _ 

flilAKn Mnu ru TUD t unrr Bu unti t ■r r^ 

*■ — -— " -.»» v>a AavAv if inwv Dn nvfv ijx U' 



INX H 
DEH 



B04FH MOV CM INR L MOV BM MOV LI 
0058H DAH MOV CM INR L MOV BM 
0061H JMP 97H 00H MOV EM 
006AB 00H MOV CB MOV AD RAL 
0073H MOV MB MOV EA RZ MOV AB 
007CH OCR L DCR L MOV AB SOB N 
90H 00H DCR L 
MOV CA IHR L SBC A 



02H 

LXI H 

MOV AM INR L 

ORA C J2 

DCH 

D6H 

MOV LI 

OCR L 



LXI H DAH 
MOV BM INR L 
XCHG 

02H 



MOV AD 
MOV MA 



MOV BM INR L 



nOv nC 



BAH _ 00H 
InX H nOv MB 
MOV MC INX H MOV MB 
08H MOV MC INX H 
MOV DM MOV MI IIH 
MOV DA MOV AE RAL MOV. EM 
RAL MOV BA MOV AC RAL 



H 
M 
L 
L 



8085H JNC 
008EH ADd; M 
0097R CALL 
00A0B D4H^ 
00A9H IMX H 
00B2H DEH 
00BBB OCff 
00C4H JMP 
00COH NOV MB INR 
00O6H MOV CH DCR 
00OFH MOV BI 00H 
00E8H C0H 00H 
00F1R BET LXI B 
00FAB OCR L SOB M 
0103a MOV MI 01B 
010CB JC 9IB 
0115B INX B MOV MI 
011EB 08B 
0127B 00B 
0I30B NOV AI 39B 
01398 MOV MA OCR L 
0142B XRA A DCR L 
014BB SOB I' 
0154B SBC A 
015DB 20B 



64B 

02B 

XCB6 

028 

tmv AH INR L 

09B 

L 

C 



00B NOV LI 
MOV C» INF L 
MOV AO ORA A 
MOV NA INX B 

MOV BM 
38B RET 
MOV MB INR L 
MOV AC INR L, 
LBLD B2B 
LXI B B5B 
KAH 02B 
JH/Z 01H 

LXI B EAH 
01B , NOV LI 
00B \ .MOV LI 
MOV MC INX Ii> MOV MB 
MOV LR MOV BC- DAD D 
SUB N -JNC 
MOV CM qCR C 
ANA N NOV LI 
MOV EA NOV AO 
JNC, 



MOV BA INR L 
MOV AB ADO H 
SBC I 80H 



04 B MOV NO INR L 
MOV BM LBLD DCB 
RAH MOV DA MOV AB RAR 
MOV MO JMP 



MOV AC SBC M 
MOV BA INR L 
JMP 6CH 

MOV ME 
02R 



LXI B 
E2B 
00B 
JC 

DAD B 
INR N 



RET 

LXI a 

MOV MI 

SUB N 

02B 

02B 

MOV MC INR L 

01B 

02B 

E9B 

E$B 

CALL 

XCB6 

3AB 



35H 80B 
ElB 02B 
02H MOV MC 
LXI B E4H 
FIB 00B 
NOV AN NOV CA 
JNP D3H 
MOV ME MOV AI 
MOV MI BFB MOV LI 
MOV AN NOV LI ECB 
MOV CR MOV LI 06B 
NOV CN INR L. MOV BM 



00B 

ANA C RRC 

MOV AI 10a 



NOV^LI 
XCB& 
NOV CI4 
NOV CM 
64B 
INR n 
08B 
SOB N 
C8B 



0166B MOV LI EEB DAD B 
016FB STAX MOV LI E9» 
0178B 00B MOV LI B6B 
01 BIB INX R MOV M» CALL 
01 SAB MOV MB MOV LI BCH 
0I93B 02B LXI IBB 
019CB LXI B EAB 02B 

01A5B MOV BA MOV EH CALL 

01ABB 0DB 0AB 0AB 0AB 20H 20H 20B 
01BBB 20B 20B 20H 20B 20H 20B 20B 
01CBH 45H 20H 4FH 46B 2flH 53H 51B 
01DBB 53H 0DB 0AB 0AR 20H S6B 41B 
BIEBB 20B 56B 41B 4CB 55B 4SB 20B 
0IFBB SSH 4SH 20B 2BB S2B 4FH 4PB 
020BH 52H 4FH 4FB 54B 20B 568 418 
021BB 0DH BAR BAB 

021EB LXI H FEB 02B MOV MI 
0227H B88 MOV BI 03B LXI B 
0230B MOV AB SBC H JC C6B 
0239B INX 8 NOV NX 0BB NOV LI 
B242H 08B MOV MC INX B MOV NB 
B24BB 01» MOV BA NOV AC SBC t. 



64H 

LXI R 

01R 
NOV AI FFB 
E6B 

SBC I 00B 
5Elf . 018 
BCB SOB N 
LXi B BOB 
NOV; LI D6B 
INR L. 

'008 NOV LI E6H 
JNP 058 BIB 
NOV LC NOV HB DAD 



008 LXI D 
EDR 028 
NOV AH ADD. I 
JNZ 438 
NOV CA MOV AN INR L. 
ORA E ' SUB I 
NOV LI EDH 
NOV CA NOV BI 
NOV CN 



MOV MC INX 8 
MOV BH MOV LI DSR 

NOV NO 
LXI B 
XCHG 



NOV EA NOV AD SBC I 008 
00B RET 

20B 208 208 20B 208 208 20R 
208 20R 20B 20B 20B 54B 41R 
S5R 41H 528 458 208 52R 4FR 
4CB 55B 45B 20B 208 S2B 4PR 
20H 52H 4FB 4FB 548 20B SSH 
548 208 56B 418 4CB 55R 45R 
4CB 558 45R 2B8 2flH 528 4F8 



B254B NOV LI OSB 
02SD8 NOV CN INR L 
B2668 64B B08 
026FB ORA B JNZ 
82788 CALL C8B 
027BB 0DB BAH 
028BH LXI B 
02898 FEB 
02928 NOV LI 
029BB F28 
02A4B 00B 
02AOB E98 
02B68 008 
02BFB DAD B 



NOV HI FAB 
NOV BM IHJV LI 
NOV AB SOB I 



808 
00B 



028 
JMP 



BIB 

FEB 

028 

FEB 

CALL 

008 

INX 8 

088 

018 

LXI a 

aSB 



INX 8 

028 
NOV LI 



MOV MI 
SUB M 
06H 



NOV CN INR L- 



S4B 
ORA B 
NOV HI 



BBH 
JNZ 
008 



NOV NC INX B 
NOV BA NOV AC 



ABB 
028 



018 



008 
INR L 
NOV MI 
MOV BM 
MOV AB 
888 
NOV LI 
NOV NB 
SBC I 
NOV EI 



02B 

MOV MC 

ORA A 

INX 

SUB 

OCR 

OCR 

MOV LI 
NOV MB 
MOV BI 
OCR B 
MOV CA 
MOV CA 
MOV AC 
BBH 
LXI B 
DAD B 
LXI H 
MOV LI 
MOV MC 
INX H 
B2H 

MOV CM 
CALL 
BBR 
0FH 
ECR 
SUB N 
MOV MC 
MOV LI 
30B 

MOV ME 
07B 
01fl 

MOV DM 
01B 

MOV NI 
00B 

MOV AC 
MOV MI 
MOV MC 
INX 8 
EEB 

MOV AB 
MOV CE 

208 20R 
42R 4CH 
4PH 54h 
4FR 54H 
41R 4CH 
20H 20H 
4FH 54H 

MOV AI 

MOV CA 

05H 

MOV LI 

SOB I 

02H 

FEB 

CALL 

008 

738 



7EB 



028 
nOV CH INR L 
E98 MOV MI 0AB 
00B MOV LI FEB 
LXI 8 E68 
NOV HI BAB 
NOV LI FEB 
SHLO FEB 



MOV EI 
NOV BN 



028 
MOV CI 
NOV CH 
028 



028 CALL 
NOV LI B6R 
NOV CI 068 
NOV CN INR L 
NOV MA INX 8 
06R MOV EI 
INR L MOV BN 
JNP 26 B 



C8R 00B 
NOV NC INX B 
MOV BI 018 
MOV BN CALL 
MOV MI 00B 
01H CALL 
LXI B 018 
02B EI 



MOV LI 
NOV MB 
CALL 
I6R 

MOV LI 
F2H 
008 
BLT 



Figure. 5-6 Generated Object Code-Pass 2 
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5 HEHORY 00300H 

25 SQOAREFOOT 000168 

26 X 002DAH 

28 Y 002DCH 

29 Z 002DEB 

33 PRINTCHAR 000C0H 

34 CHAR 002E1H 

37 PKINTSTRING 000C8H 
39 tIANB 0f2E2B 
39- LBNGTB 002E4H 
41 I 002B5H 

46 PRINTMaHBER 000P2H 

47 RtlHBER 0B2B6B 
4» BASE 002B9B 
49 CBARS 002BAH 

- 5» ZBROSQPPRESS 0e2BBH 
Si I B02BCB 

53 J 002EDH 

54 TEMP 0B2EEH 
64 I 002FBB 

66 BEADING 001ABB 



il000100i3lD402C31EB221DA027123702D4E2C4608 
11B0B20B02C71237B2ADA0223BB7AB71F577B1P212A 
S1O0B3000DE0277237221DC027E2C462C962C4P7830 
:18C940009EB1CABX002O4E2C462EDC7123702O4C67 
S1B9B500B2C462ED67123702EDA4E2C4S2ED87W3C4 
tIBBf6B9B70C397005B2O563611069B487A17577BED 
tl«e»7000175ElD735FC878174779174F2D2D789637 
jie0B8B«B472C;799E4FD290002D7886472C798B4F41 
sl0Bf900i2C9PDB80C36C00CD64002ED4722C7321A3 
tlB00A090D4»24E2C4«2ADC02B923EB7AB,71FS77B73 
tl000B0001F21DE02772372CJ35B02EDC7E2C46C959 
tli00C0BB21Bl0271C3B938C921B2B27r23702C7346 
:1«00O0002C360021E4024EOD792C96DAF1004E«602 
S1000EBB0002AB202097E4FCDC00B21E50234C3D3CO 
S1000F00000C921EA02712C733E0F2O96D201013600' 
»ie»10t»0BF2BEC36B121BA»27E2EElC96DA91O12EBA 
tlBallt«BE94B2BD6712336002EE64B2C462ED8718F 
tlBM2Bf»2370CD64BB1138eB686n9EB21ED02737» 
tlBfl3B0»3B3996D23A017BC6B7772D4B0D3EFFC25C 
xl0«40004301AF2DA»2BE64F7E2C56D6005F7AOEP9 
:l«BI599000B3D6019FAlBFD25Ei012BED36203E10D6 
»10016«9B2BEC964Fr6002BBE99EB21ED024E79I291 
:1*B1700»2EB94E2BD6712336B02EE64B2C462ED872 
tl«fl8»00712370CD64Bi2EB67223732EEC34C39508 
tl0B19B000101EE02111000696019EB7B21EAB29661 
tie»lA0005P7ADEO04B475ECDC800C90DflA0A0A20FP 
tlf01B0002B2020202020202020202020202020203F 
II001C0BB2020202020202B5441424C45204P462812 
tlfBlDB0053515541524520S24F4F54530D0A0A2056 
tl§BlB«0B56414C55452820524F4F542056414C55B6 
jlBeiF0»B452020524F4F542056414C554520205207 
slBt200»04F4F542056414C55452020524F4F5420BB 
tl002i00056414C55452020524F4P54»D0A0A21FE9D 
rl0B22000B2360123360B3EE8060321FE02962C4FDB 
tl0fl2300B789EDAC6»22EDfi36052336002EFE4E2CC8 
slf«4tBB462EO8712370CD640078D6014779DE0»4B 
tlB»2500BBBC288022ED636PA23360«2EFB4B2C4629 
jlBt26BBB2BD87i2370CO640078D6014779DE00B0B6 
tltt27BB0C280B201ABBlIE73CDC80BC388020D0Afl3 
tl0»28000«17E021E«2CDC80B2BFE4E2C462EE671C7 
tlBi29BB»23702EE93«0A0EB61E01CDF2B02EPB4E08 
.1B02AB002C46CO160B21E6B2772336002EE9360AC9 
»lf»2B0900E061B01CDF2002EFE4B2C4621O1000935 
t0802CB0022FB02C326ft2P676B8 
' t 0000000009 



Figiire 5-7 Hexaaeclmal Object Code File-Pass 2 
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6. RUN-TIME CONVENTIONS 

This section presents the run-time organization of PL/M pro- 
grams, including storage allocation and sxibroutine linkage, in an 
8080 CPU environment. 

6.1 Storage Allocation 

The organization of memory for a PL/M object program is shown 
in Figure 6-1. Memory is allocated in three sections: 

1. Instruction Storage Area (ISA) 

2. Variable Storage l^ea (VSA) 

3. Free Storage Area (FSA) 

The ISA is occupied by the machine code generated by the PL/M 
source, and variables declared in DATA declarations. 

The VSA is located above the ISA, and contains (in order of 
decreasing address) : 

i. Variables, other than DATA variables, declared in the 

PL/M source.. They are arranged in order of declaration. 
ADDRESS variables are aligned on an even-byte boundary. 
BYTE variables ar^ not aligned. 

2.. Compiler generated temporaries i.e* workspace used by the 
, object program, but not explicitly declared. 

the compiler, unless explicit overrides are used. 
(See 6.4) . : 

The compiler will normally locate the VSA directly above the 
ISA, However the compiler user may specify the first page of the 
VSA explicitly, using, the pass 2 $V compiler control. (A page 
contains 256 bytes). This may be used, for example, to enstire that 
the VSA is located in RAM for a system that has both RAM and ROM. 

FSA is the area of memory above the VSA. The built-in PL/M 
identifier MEMORY may; be used to reference the FSA. 
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65535 




Max. Memory Size 


< 




^."""'''^ FREE 
STORAGE 
AREA 
(FSAJ 



'* MEMORY VECTOR 



.MEMORY 
(page botmdsary) ^ 



Variable Stor- 
age Area ^g^ 



^— Last Declared Variable 



Storage For 
Declared Variables 






t_: 



I— First Declared Variable 
Temporaries 



[Base of Stack - ft 

STACK 
[Top of Stacjc__ «_— — — 

/.■y / / / / P 



$v 



> Unused area (always 
less than 1 page if $V=0) 



INSTRUCTION 
STORAGE 
AREA 
(ISA) 



Program Origin 
$H or Numeric Label 



/, 


\-- 




/ 


/ 


/ / . 



/ 



/ 




UNUSED 

/ 



I RESTART LOCATIONS | ^ 



ISA. 



Figure 6-1 Run-time Storage Organization 
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6,2 Procedure Linkage Conventions 

Formal parameters declared in a procedure definition are 
treated as locally defined variables. That is, each parameter is 
allocated storage sequentially in memory as if it were a variable 
local to the procedure. During procediire invocation, actual para- 
meters are evaluated, and the results assigned to the corresponding 
formal parameters. All piarameters are "call by value" in PL/M. 

The conventions for passing parameters are as follows: 

1. A single BYTE parameter is passed in register C. A single 
ADDRESS parameter is passed in registers B (high order byte) 
and C (low order byte) . 

2. If these are two parameters, the first is passed as described 
above; the second is passed in registers D (high order byte, 
if any) and E( low order byte) . 

3. When there are more than two parameters, the last two are 
sent as described above, and the remainder are assigned 
directly, prior to the actual CALL. 

GPU registers are also used to hold results returned by pro- 
cedures which have the BYTE or ADDRESS attribute. In the case of - 
a BYTE procedure, the value returned is in the A register, while 
an ADDRESS procedure returns the low-order byte in register A, and 
the high-order byte in register B. 
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6.3 Use of Assembly Language Subroutines with PL/M 

Assembly leuiguage subroutines can be incorporated with PL/M 
programs provided they take account of the PL/M conventions dis- 
cussed in Section 6.2. 

If assembly language subroutines are loaded at addresses SI, 
S2, . . . Sn Csee Figure 6-2) » the PL/M program should have inter- 
face procedures PI, P2, . . . Pn where each Pi is a procedure con- 
taining only the absolute jvimpt 

qo TO Si; 

Each procedure Pi can have up to two parameters of type BYTE 
or ADDRESS, and can also return a value. If more than two parameters 
are required or more than one value is to be returned, then ADDRESS 
variables may be used to .'point to' parameters or results. Each 
assembly leuiguage subroutine Si obtains parameters and returns 
results, according to the conventions presented in Section 6.2. 

Suppose r for exeunple, three subroutines are written in assembly 
language for handling teletype I/O. The subroutine CRLF sends a 
line-feed-carriage-retum, and is at memory location 50. The sub- 
routine TTYOOT writes a single character at the teletype. TTYOUT 
starts at location 75. The subroutine TTYIN reads one character from 
the teletype, and is located at address 120 ► The following PL/M 
fragment provides appropriate interface procedures! 

DECLARE CRLFS LITERALLY '50', 

TTYOUTS LITERALLY '75', 
TTYINS LITERALLY '120'; 

/* INTERFACE FOR CRLF */ 

CRLF: PROCEDURE; 

GOTO CRLFS; 
END CRLF; 

/* INTERFACE FOR TTYOUT */ 

TTYOUT : PROCEDURE (CHAR) ; 
DECLARE CHAR BYTE; 
GOTO TTYOUTS; 
END TTYOUT; 

/* INTERFACE FOR TTYIN */ 

TTYIN t PROCEDURE BYTE; 
GOTO TTYINS; 
END TTYIN; 



MCS-80 MEMORY 
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PSA 



V S A 



PL/M Origin: 



ISA 
GGntaining Prooedures 

Pj_, Pj, ... , Pj^ 



SUBROUTINE n 



SUBROUTINE 2 



SUBROUTINE 1 



Figure 6-2 Including Assembly Language Subroutines 
with PL/M Programs . 
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The user should take care if his assembly language routines 
make use of the 8080 stack. Firstly, the size of the VSA as deter- 
mined by the PL/M compiler will take account only of the stack 
requirements of the PL/M source. Secondly, the assembly language 
routines, on return, must leave the stack pointer with the same 
value as it had on entry. 
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6.4 Stack Manipulation 

The use of the 8080 stack is completely automatic in PL/M. It 
is used, for exan^jle, to hold return addresses, temporary results, 
and system status dtiring^ interrupt processincr. 

The number of bytes allocated for the stack is determined during 
con^ilation, and assumes no more than one simultaneous activation 
of any given procedure (including INTERRUPT procedures) at any time 
during execution. 

The 8080 stack pointer register is reset to the address of the 
base of the stack on the following occasions: 

- a) Program entry, 

b) At numeric labels in the outermost block. 

c) Transfers of control to the outermost block from nested 
inner procedures. "» 

Automatic stack allocation may be bypassed with the $*=n com- 
piler control in pass 2, In this case, no stack area is reserved 
in the VSA, emd the stack pointer is reset to the value n at (a) , 
(b) , and (c) , above. In this way the programmer may explicitly con- 
trol the location, and consequently size, of the stack. 

The PL/M compiler also provides for stack operation under total 
control of the programmer. This is accomplished by setting $*=1 
during pass 2. In this case, no space is reserved for the stack in 
the VSA, and no automatic reset of the stack pointer takes place. 
Its value must be controlled explicitly with the STACKPTR pseudo- 
variable in PL/M. 



6.5 Interrupt Processing 

The object code corresponding to a procedxire with the INTERRUPT 
n attribute is such that it may be entered by a transfer of control 
to location 8n in memory. Location 8n contains a jump to the re- 
mainder of the object code of the procedure. Consequently, an inter- 
rupt procedure can be invoked by forcing a RST n instruction on the 
8080 interrupt port. 

Upon execution of the RST n instruction, the current program 
counter (PC) is pushed on the stack, and control passei^ via loca- 
tion 8n, to the interrupt procedure. At entry to the interrupt pro- 
cedure; CPU registers are stacked in the following sequence: 

1. (H,L) 2. (D,E) 3. (B,C) 4. (A, Flags). 
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The interrupt procedure remains active until a corresponding PL/M 
RETURN statement is encountered, or control passes to the end of 
the procedure. All stacked registers (except PC) are restored, 
interrupts enabled, and a RET operation is executed (which restores 
PC), causing control to rettim to the point of interruption. 

If a PL/M program contains interrupt procedures, locations 
through 811 + 2 (where n is the highest numbered interrupt procedure) 
will be reserved for unconditional branches to the procedure bodies. 
Locations 0, 1, and 2 contain an \inconditional jump to the origin 
of the PL/M program (unless interrupt zero is used) . 

Note that the 8080 processor starts with interrupts disabled, 
and disables interrupts when an interrupt is accepted. PL/M object 
code enables interrupts before returning from an interrupt procedure, 
and before all program halts. 
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8080 PL/M COMPILER PASS 1 
ERROR MESSAGES 



Error 

Number l^fSiSSS. 



The symbols printed below have been used in the 
current block but do not appear in a DECLARE state- 
ment j or label appears in a GO TO statement but 
does not appear in the block. 

Pass-1 compiler Sjmibol Table overflow. Too many 
symbols in the source program. Either reduce the 
number of variables in the program, or re-compile 
Pass-1 with a leirger Symbol Table. 

Invalid PL/M statement; the pair of symbols printed 
below cannot appear together in a valid PL/M state- 
ment (this error may have been caused by a previous 
error in the program) . 

Invalid PL/M statement. The statement is improperly 
formed - the parse to this point follows (this may 
have occurred because of a previous program error) . 

Pass-1 Parse Stack overflow. The program state- 
ments are nested too deeply. Either simplify the 
program structure, or re-compile Pass-1 with a 
leU7ger Parse Stack. 

« 

Number conversion error. The nximber either exceeds 
65535 or contains digits which conflict with the ra- 
dix indicator^. 

Pass-1 table overflow. Probable cause is a constant 
string which is too long. If so, the string should 
be written as a sequence of shorter strings, separa- 
ted by commas. Otherwise, re-compile Pass-1 with sL 
larger VARC table. 
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8 Macro Table overflow. Too many LITERAL declara- 
tions. Either reduce the number of LITERAL declara- 
tions, or re-compile Pass-1 with a larger 'MACROS* 
table. 

9 Invalid constant in INITIAL, DATA, or in-line con- 

StcUlt . 

Precision of constant exceeds two bytes (may be in- 
ternal Pass-1 compiler error) . 

10 Invalid program. Program syntax incorrect for ter- 
mination of program. May be due to previous errors 
which occurred within the program. 

11 Invalid placement of a declaration within the PL/M 
program. Declarations may only appear in the outer 
block or within DO-END groups (not iterative DO's, 
DO-WHILE 's, or DO-CASE/s). 

12 Improper use of identifier following an END statement. 
Identifiers can only be used in this way to close a 
procedure definition* 

13 Identifier following an END statement does not match 
the name of the procedure which it closes. 

14- Duplicate formal parameter name in a procedure head- 

15 Identifier following an END statement cannot be found 
in the program. 

16 Duplicate label definition at the same block level. 

17 Nvuaeric label exceeds CPU addressing space. 

18 Invalid CALL statement. The name following the CALL 
is not a procedure. 

19 Invalid destination in a 60 TO. The value must be a 
label, simple variable, or numeric constant. 

2 (J Macro Table overflow (see error 8 above). 
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21 Duplicate variable or label definition. 

22 Variable which appears in a DATA declaration has 
been: previously declared in this block. 

23 Pass-1 Symbol Table overflow (see error 2 above). 
2f Invalid use of an identifier as a variable name. 

25 Pass-1 Symbol Table overflow (see error 2 above). 

26 Improperly formed BASED variable declaration. The 
form is I BASED J, where I is an identifier not pre- 
viously declared in this block, and J is an ADDRESS 
variable. 

27 Ssnnbol table overflow in Pass-1. (See error 2 above). 

28 Invalid address reference. The DOT operator may only 
precede simple and subscripted variables in this 
context. 

29 Undeclared variable. The variable must appear in a 
DECLARE statement before its use. 

30 Subscripted variable or procedure CALL references 

an vindeclared identifier. The variable or procedure 
must be declared before it is used. 



31 The identifier is improperly used as a procedure or 
subscripted variable. 

32 Too many subscripts in a subscripted variable refer- 
ence. PL/M allows only one subscript. 

33 Iterative DO index is invalid. In the form 'DO I 
= El to E2' the variable I must be simple (unsub- 
scripted) . 

34 Attempt to complement a compiler control where the 
control currently has a value other than or 1. 

35 Input file number stack overflow. Re-compile Pass-1 
with a larger INSTK table. 
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36 Too many block levels in the PL/M program^ Either 
simplify your program (30 block levels are currently 
allowed) or re-compile Pass-1 with a larger Block 
Table . 

37 The number of actual parameters in the calling se- 
quence is greater than the ntamber of formal para- 
meters declared for this procedxire. 

38 The nxmber of actual parameters in the calling se- 
quence is less than the number of formal parameters 
declared for this procedure. 

39 Invalid interrupt number (must be between Q and 7 ) . 

1+0 Duplicate interrupt procedxire number. A procedure 
has been previously specified with an identical in- 
> terrupt attribute. ^ 

41 Procedure appears on left-hcind side of an assign- 
ment. 

U2 Attempted 'CALL* of a tjrped procedure. 

1+3 Attempted^ use of an untyped procedure as a function 
or a variable. 

U-if. This procedure is untyped and should not return a 
value. 

45 This procedure is typed and should return a value. 

46 * RETURN' is- invalid outside a procedvire definition. 

47 Illegal use of a label as an identifier. 
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8080 PL/M COMPILER PASS 2 
ERROR MESSAGES 



Error 

Number Message 



101 Reference to storage locations outside the virtual 
memory of Pass-2. Re-compile Pass-2 with larger 
'MEMORY' array. 

102 (Same as 101). 

103 Virtual memory overflow. Program is too large to 
compile with present size of 'MEMORY'. Either 
shorten program or recompile Pass-2 with a larger 
virtual memory. 

104 (Same as 103). 

105 Control used improperly in Pass-2. Attempt to com- 
plement a control which has a value other than or 1, 

106 Register Allocation Table underflow. May be due 
to a previous error. 

107 Register allocation error. No registers available. 
May be caused by a previous error, or Pass-2 com- 
piler error. 

108 Pass-2 Symbol Table overflow. Reduce number of 
symbols, or re-compile Pass-2 with larger Symbol 
Table. 

109 Symbol Table overflow (see error 108). 

110 Memory allocation error. Too much storage speci- 
fied in the source program. Reduce source program 
memory requirements. 

111 Inline data format error. May be due to improper 
record size in Symbol Table file passed to Pass-2. 
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112 (Same as error 107). 

113 Register Allocation Stack overflow. ^ Either sim- 
plify the program or increase the size of the Allo- 
cation Stacks. 

im Pass-2 compiler error in 'LITADD' — may be due to 
a previous error. 

115 (Same as 114-). 

116 (Same as ll»t) . 

117 Line width set too narrow for code dump (use $W=n) . 

118 (Same as 107). 

119 (Same as 110) . 

120 (Same as 110, but may be a Pass-2 compiler error). 

121 (Same as 108). 

I22I- Program requires too much program and vcuc»iable 
storage. 

123 Initialized storage overlaps previously initialized 
storage. 

121* Initialization Table format error. (See error 111). 

125 Inline data error. May have been caused by previous 
error. 

126 Built-in ftjnction improperly called. 

127 Invalid Intermediate Language format. (See error 
111)^ 

128 (Same as error 113). 

129 Invalid use of built-in function in an assignment. 

130 Pass-2 compiler error. Invalid variable precision 
(not single byte or double byte). May be due to 
previous error. 
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131 Label resolution error in Pass-2 (may be compiler 
error) . 

132 (Same as 108). 

133 (Same as 113). . 

134- Invalid program transfer. 

135 (Same as 134). 

JL36 Error in built-in function call. 

137 (Not used). 

138 (Same as 107). 

139 Error in changing variable to address reference. 
May be a Pass-2 compiler error, or may be caused 
by previous error. 

1»*0 (Same as 107). 

141 Invalid origin. Code has already been generated in 
the specified locations. 

142 A Symbol Table dump has been specified (using the 
$MEMORY toggle in Pass-1), but no file has been 
specified to receive the BNPF output (use the $BNPF=n 
control) . 

143 Invalid format for the Simulator Symbol Table dump 
(see error 111). 

144 Stack not empty at end of compilation. Possibly 
caused by previous compilation error. 

145 Procedxores nested too deeply (HL optimization). 
Simplify nesting, or re-compile with larger PSTACK. 

146 Procedure optimization stack underflow. May be a 
return in outer block. 

147 Pass-2 compiler error in LOADV. Register stack 
order is invalid. May be due to previous error. 
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ma Pass-2 compiler error. Attempt to unstack too 
many values. May be due to previous error. 

149 Pass-2 compiler error ► Attempt to convert invalid 
value to address type. May be due to previous 
error. 

150 (Same as 147). 

151 Pass-2 compiler error. Unbalanced execution stack 
at block end . May be due to a previous error . 

152 Invalid stack order in APPLY. May be due to pre- 
vious error. 
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PASS 1 COMPILER CONTROLS 



CONTROL VALUES DEFAULT 



Q,l 



B 



M 
H 

*0 



0,1 



D 


Fixed 


120 


E 


0,1 





F 






6 


0,1 





H 




■ 


*I 


1^7 


1 


J 


1-7 


6 


K 


Fixed 


72 


*L 




1 



0,1 



1-7 



USE 

Print syntax analysis trace. 
(Compiler diagnostic only) . 

Inhibit stack dump after syntax 
errors. (Compiler diagnostic 
only). 

Contains current source line 
nximber . 

Pass 1 buffer size for output files. 

Emergency termination when set. 

Unused 

Display Intermediate Code. (Com- 
piler diagnostic only ) . 

Unused . 

File nximber of Pass 1 input stream. 

File number for Intermediate Code 
emitted by Pass 1. 

Value assumed by 'W Toggle for In- 
termediate Code file. 

Leftmargin. Specifies first charac- 
ter position processed on each input 
line. Any leading characters are 
ignored . 

Transmit full Symbol Table to Pass 2. 

Unused 

File number for list file. 



* Compiler controls identified by an asterisk are the only ones 
the compiler user should need to use. 
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CONTROL VALUES DEFAULT 
*P 0,1 1 



Q 

*R 



80 Max 72 



0,1»2 



T 


0,1,2 1 


U 


1-7 7 


V 


Fixed 72 


w 


120 Max 72 


.X 




Y 


Fixed 1 



USE 

Echo input if one. Suppress if 
zero. 

Unused 

Rightmargin. Ignore characters 
R+1, R+2,... on each input record. 

Print Pass 1 Symbol Table. (Com- 
piler diagnostic only). 

n-D-,4-y^v, 1=Tn-«-«»r>ar>-t--i ve. 2 = Inter- 

list. (See Note 1.) 

Intermediate Symbol Table file num- 
ber . 

Setting" of ^W dontrol for Inter- 
mediate Symbol Table file. 

Maximum number of characters per 
record output to the list file. 
(See notes 2 and 3). 

Unused 

Output text begins at character 
position 'Y' of each record. Lead- 
ing character positions are space- 
filled. (Applies to all files). 



Unused 
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Note 1. *$T=1' signifies that Pass 1 is operating interactive- 
ly. This causes output to be double-spaced, with the 
intention of correctly interleaving it with input. Ad- 
ditionally, if the Pass 1 listing is directed to a de- 
vice other than the terminal, a svunmary error report 
is directed to the terminal at the end of Pass 1. 

•$T= a' signifies batch operation. Output is single- 
spaced but may not be synchronized with the input. 
The error summary is suppressed. 

Note 2. All output from Pass 1 is produced by the subroutine 

♦WRITEL*. This will write to all files using variable 
length records in which all trailing space characters 
are suppressed. Additionally, a leading space, over 
and above those specified by the controls, is added 
to each output record as a 'print control character'. 
Mote that this applies also to both intermediate files. 

Note 3. Complete echo of the source input requires a width 
of 94 characters. A setting of the $W control to a 
value less than this causes one input line to be echoed 
using two print lines. If the latter portion of the input 
line is bleink this may give the appearance of double 
spacing. 
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PASS 2 COMPILER CONTROLS 

CONTROL VALUES DEFAULT USE 

Register allocation trace. (Com- 
piler diagnostic only) . 

File number for BNPF/Hex output 
by Pass 2. indicates BNPF/Hex 
file not to be created. 

Contains line count from original 
spTirce f ilev 

Pass 2 buffer size for output 
files. 

Emergency termination of Pass 2. 

Display decoded memory initializa- 
tion-. ■ 

*G 0,1,2 a: Off 

1: Display cross-reference table of 
approximate memory address versus 
source line number. 
2 : Display intermediate language. 
(Compiler diagnostic only) . 

*H Header. Decimal address at which 

Pass 2 should start allocating space 
for the generated code, i.e., the 
start of the program's ISA. 

I 1-7 1 File number for Command File input 

to Pass 2. 

J 1-7 6 Intermediate Code file number. 

K Unused 



A 


0,1,2 





B 


0,1-7 


7 


C 






D 


Fixed 


12 


E 


0,1 





*F 


0,1 
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CONTROL VALUES DEFAULT 
L Fixed 1 



*M 


0,1 


1 


N 


0,1 





*o 


1-7 


1 


P 


0*1 






R 



T 
U 

*V 



W 



0,1 



Fixed 



0,1,2 

0,1,2 
1-7 



120 Max 



73 



1 
7 



72 



USE 

Leftmargin. Specifies first 
character position processed on 
each record input from the com- 
mand file. Leading characters 
are ignored. 

Display Symbol Table. 

Display emitter trace. (Compiler 
diagno st ic only . ) 

File number for List File. 

Echo input. (Compiler diagnostic 
only) , 

0: Object file written in 'BNPF' 

format . 
1: Object file written in Hex format. 

Rightmargin. Ignore, characters 
R+1, R+2, ... on each input record. . 
(Applies to Command , Intermediate 
Code, and Symbol Table Files). 

Display codified Pass 2 Sjmibol 
Table. (Compiler diagnostic on- 
— _, . . 

See Pass 1 'T' control. 

File niimber of Intermediate Sym- 
bol Table. 

Page number of the first page of the VSA. 
i.e., variable storage, stack, etc. 
If set to zero: Pass 2 allocates 
space at the first available page 
above the ISA. 

Maximum number of characters per record 
output. (Applies to both the list, 
and BNPF/Hex files. See Note 1). 
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CONTROLS VALUES DEFAULT 



USE 



X 

Y Fixed l 



Fixed 



Unused 

Outpiit text begins at character 
position *Y' of each record. 
Leading character positions are 
spacefilled. (Applies to all out- 
put files) . 

Value of 'L' control for intermediate 
files - both Symbol Table and Code. 



Note 1. All output from Pass 2 is produced by the subroutine 
*WRITEL' ► This will write to all files using vari- 
}able length records in which trailing spaces are 
suppressed. Additionally, a leading space is added 
to each output record as a ' print control character ' . 
Note that this applies to the BNPF/Hex file as well 
as the list file. 
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GENERAL PILE MAPPINGS 









Pass 


_l 








Input 








Output 




Control Value FORTRAN 


Unit 




Control Value 


FORTRAN Unit 


1 




5 






1 


5 


2 




2 






2 


3 


3 




6 






3 


7 


If 




16 






1+ 


17 


5. 




9 






5 


10 


6 




20 






6 


22 


7 




21 






7 


23 



Pass 2 





Input. 






Output 




Control Value 


FORTRAN Unit 


Control Value 


FORTRAN Unit 


1 




5 


1 




5 


2 




2 


2 




3 


3 




_ 5 


3 




7 


4 




16 


H 




17 


S' 




9 


5 




10 


a 




22 


6 




20 


7 




23 


7 




21 
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GENERAL ELECTRIC FILE DEFINITIONS 



Pass 1 





Input 




Output 




Control Value 


File Definition 


Control Value J 


File Definition 


1 
2 






TTYINl 


1 
2 


TTYOUTl 
PTRl 


3 
- J+ 
5 
6 
7 






FILEIN 


3 

5 
6 
7 


INTFIL 
SYMFIL 



Pass 2 



Input 
Control Value File Definition 



Output 
Control Value File Definition 



1 
2 
3 
i» 
5 
6 
7 



TTYIN2 



INTFIL 
SYMFIL 



1 
2 
3 
If 
5 
6 
7 



TTY0UT2 



LOGOUT 
L06BIN 
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TYMSHARE FILE DEFINITIONS 



Pass 1 



Input 
Control. Valae File Definition 



1 
2 
3 

5 
6 
7 



Terminal 

F0R02.DAT 

FOR06.DAT 

F0R16.DAT 

F0R09.DAT 

FOR20.DAT 

F0R21.DAT 



Output . . 
Control Value File. Definition 



1 
2 
3 
4 
5 
6 
7 



Terminal 

F0R07.DAT 
F0R17 . DAT 
FOR10.DAT 
F0R22.DAT 
F0R23.DAT 



Pass 2 



Input 
Control Value File Definition 



1 
2 

a 

5 
6 
7 



Terminal 

FOR02.DAT 

FOR06.DAT 

F0R16.DAT 

FOR09.DAT 

F0R22.DAT 

F0R23.DAT 



Output 
Control Value File Definition 



1 
2 
3 

5 
6 
7 



Terminal 

FOR07.DAT 
F0R17.DAT 
FOR10.DAT 
FOR20.DAT 
F0R21.DAT 
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UNITED COMPUTING SYSTEMS FILE DEFINITIONS 



Pass 1 





Input 






Output 


Control Value 


File Definition 


Control V. 

1 
2 


alue File Definition 


1 
2 






P801IN 


paoiouT 

PTR801 


3 

5 
6 
7 






FILES 


3 

5 
6 
7 


INTFIL 
SYMFIL 



Pass 2 



Input 
Control Value File Definition 



1 
2 
3 
k 
5 
6 
7 



P802IN 



INTFIL 
SYMFIL 



Output 
Control Value File Definition 



1 
2 
3 
4 
5 
6 
7 



P802OUT 



L0G80 
LOGS 80 



